home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Various / Amigan Amateur Radio Group Public Domain Disk 5 (1988)(Amigan Amateur Radio Group)(PD)[WB].zip / Amigan Amateur Radio Group Public Domain Disk 5 (1988)(Amigan Amateur Radio Group)(PD)[WB].adf / AmigaBBS / BBS.DOC < prev    next >
Text File  |  1989-01-01  |  8KB  |  186 lines
  1.  
  2. BBS.DOC    881220  AMIGA AMATEUR RADIO PACKET TERMINAL/BBS PROGRAM
  3.  
  4. * The program will be referred to as BBS, but you will find it as
  5. * P1103.ASM (source) or P1103 (runable). P1103 means November 3, 1988.
  6.  
  7.    This is a program written in Assembly Language for the Amiga computer
  8. to run PACKET radio as a backround task.  It uses the Amiga Serial port
  9. to interface to a Terminal Node Controller (TNC).  The TNC is connected
  10. to the Amiga thru a RS-232 serial cable, and to a VHF or HF radio thru
  11. Receive audio, Microphone audio, and PTT lines.
  12.  
  13.    The terminal part should run on any TNC, but the BBS part will only
  14. run on a KANTRONICS KPC-1, KPC-2, KAM, or KPC-4.  DUAL PORTING works with
  15. the KAM or KPC-4.  See DISP files for parameters.
  16.  
  17.    NOTE: Stack must be set to 8000 or more. Suggest setting Stack 8000
  18. and CD RAM:.  TNC ECHO must be turned on. This program will do its own
  19. SERIAL port initialization and runs with HARDWARE RTS/CTS HANDSHAKING.
  20.  
  21.    SERIAL PORT:  (This for A1000.  A500 or A2000 may be different !!!)
  22. DO NOT CONNECT ALL 25 WIRES !!!  Some have supply voltages.
  23.  
  24. AMIGA > TNC
  25.     1 - 1  GND    AMIGA 6 (DSR) tied to AMIGA 20 (DTR)
  26.     2 < 2  TD     AMIGA 8 (DCD) tied to AMIGA 21 (+5V) thru 1k resistor
  27.     3 > 3  RD
  28.     4 > 4  RTS    No other wires are connected.
  29.     5 < 5  CTS
  30.     7 - 7  GND
  31.  
  32. NOTE: Amiga pin 8 probably can be left blank.  I installed the pull up
  33. resistor years ago and don't remember why(?).
  34.  
  35.    "RUN PBBS" will will bring up a full, borderless, window in non-
  36. interlaced or interlaced mode.  Works well with overscan WB screen.
  37. This window can be re-sized under AmigaDos 1.2 or made smaller and
  38. moved to any part of screen.
  39.  
  40.    Function Keys: (As appear in window title line)
  41.  
  42. HELP Displays current status. ^=BBS active M=monitor mode on, B=BBS
  43.      enabled, Capture filename, I/O baud rate, number of characters
  44.      and lines in capture buffer.
  45.  
  46. F1 - Prompts for a file name that will CAPTURE communications to/from
  47.      TNC to the named file. Default is to the current directory, but
  48.      regular file names and paths may be entered, either to disk, RAM,
  49.      or printer.  Note that PACKET has an internal 4k buffer that fills
  50.      up first before dumping to capture file.
  51.    - Hit F1 again to toggle closed CAPTURE file.
  52.  
  53. F2 - Prompts for a filename for a text file that you want to SEND to
  54.      another station. File SEND will start immediately. TNC ECHO must
  55.      be turned on for this to work.
  56.    - Hit F2 again during SEND to cancel.
  57.  
  58. F3 - Sets BAUD to next lower rate. 9600, 2400, 1200, 300 bauds are
  59.      available. Program defaults to 9600 baud. TNC ABAUD parameter
  60.      must be the same as PACKET baud on Amiga.
  61.  
  62. F5 - Toggles MON mode. With M=OFF, Amiga looks almost like a dumb
  63.      terminal and does character I/O.  M=ON causes line I/O and
  64.      trashes much of the duplicate CALL>CALL,DIGI1,DIGI2 lines, and
  65.      will only display full lines from TNC - TNC must echo a full
  66.      line that you type before it will be displayed. This mode is
  67.      used with Kantronics KPC with HEADERLN=ON in TNC.
  68.      N3ET>KB3UD,K3WGV-1:                  CALL>CALL,DIGI:
  69.      Hello fron Allentown, Pa.            Packet text
  70.  
  71. F6 - Opens a NEWCLI window. Remember this command when you GURU on
  72.      another task.  Click in new window and save files, then re-boot.
  73.  
  74. F7 - After connecting to a station, BBS is forced on and forwards msgs
  75.      that are for that BBS.  Then a F> is sent for reverse forwards.
  76.  
  77. F8 - Supposed to break into BBS connection to talk to user.  Code not
  78.      completed yet, so DO NOT USE!!
  79.  
  80. F9 - Toggles BBS enable/disable, indicated by 'B' status with HELP key.
  81.      With BBS disabled, you remain in terminal mode when someone connects.
  82.  
  83. F10- Same as WINDOWCLOSE gadget in upper left of window. Closes all
  84.      open capture or send files, then quits.  NOTE: When BBS is active,
  85.      F10 key will disconnect station (may wait for 4 minute timeout).
  86.  
  87.  
  88.    NOTES: This is a borderless window to get the most on a screen.
  89. You may at times get confused as to where the window starts and stops.
  90. Suggest a full screen PACKET window, with other tasks running on top.
  91. The WINDOWCLOSE, FRONT, BACK, RESIZE, and DRAG gadgets are all there,
  92. but typically invisable - click on BACK gadgets in upper right to make
  93. things visable again.  Note function key help in title line.
  94.  
  95.    When program is first run, CHARS/LINES will display starting and
  96. ending addresses of the program in DECIMAL.  It will do this until a
  97. CAPTURE file is opened.
  98.  
  99.    When SENDing a file, characters are sent to the TNC and program will
  100. not send more characters until it sees them ECHOed back. This
  101. program is set up for HARDWARE RTS/CTS handshaking ONLY.
  102.  
  103.  
  104. ------
  105. SOURCE CODE
  106. ------
  107.  
  108.    Hey people!  The Assembly source code is included.  It was written by
  109. me for me.  You will have a hard time with it, but play anyway.  Please
  110. give it away or change it, or anything, but DON'T SELL IT OR THE PROGRAM.
  111.  
  112.    The source is complete. Nothing else is needed except ASMB and ALINK.
  113. It assembles fast, but is somewhat inflexible.
  114.  
  115.    Put a copy of BBS.ASM in RAM: and do following:
  116.  
  117. ASMB RAM:BBS.ASM -o RAM:BBS.o
  118. ALINK RAM:BBS.o to RAM:BBS
  119. STACK 8000
  120. RUN RAM:BBS ... then type F3 until baud is correct.
  121.  
  122. ------
  123. BBS operation
  124. ------
  125.  
  126.   BBS expects to find 7 files on a disk named B: and these files are
  127. addressed:
  128.  
  129.  B:DIR  Maintains directory of messages that are sent.
  130.  B:USR  Maintains user information.
  131.  B:FWD  Used when forwarding messages.
  132.  B:BID  Maintains list of $BIDs for bulletin dupe rejection.
  133.  B:0    This is MY plug (N3ET) for AmigaBBS
  134.  B:1    This is a list of BBS commands.  Give the user a break and keep
  135.         it short - he needs help, not 20k of bullshit!
  136.  B:2    This is your plug.  Tell the user about YOUR system.  This will
  137.         eventually be the response to the future 'I' command for INFO.
  138.  
  139.  
  140.  SYSOP entry of messages is quite poor at this time, but goes like this:
  141.  
  142.    Use ED to build a message.  Then save as say, B:4.  Type "L B:4" and
  143.    note message length.  "ED B:DIR" and add new first line, mimic line
  144.    below it:
  145.  
  146.    "   4 BN  12345 ALL    WB3KTW        8712312359 Hello all"
  147.     ---- -- ------ ------ ------ ------ ---------- ---------
  148.    "msg# PS LENGTH TO     FROM   @BBS   YYMMDDHHMM Title    "
  149.  
  150.   I know, you aint got ED, so your gonna have to wing it with your own
  151. editor.  May I suggest that you have someone connect and send a message
  152. or 2 and then have him KILL them.  Then take a look at B:DIR and the
  153. messages.  You, as SYSOP, will have to duplicate what the BBS does if
  154. you want to put a message in your system.
  155.  
  156.  
  157.   In the B:USR file, clean it up every now and then by deleting the older
  158. lines (one line must remain as a `seed'.  Format is:
  159.  
  160. WA3MNT  8712312359  0025     3  Randy
  161. ------  ----------  ----  ----  --------
  162. CALL    YYMMDDHHMM  CONS  Nmsg  Name
  163.  
  164.  
  165.   Never delete top entry in DIR or new messages will overwrite previous
  166. messages.  If you want to force a BBS message to whoever you are connected
  167. to, then change B:DIR line to "   4/PN  " etc.  The slash '/' tells the
  168. BBS to forward this message when it receives F> (as in reverse forward) or
  169. when you connect to someone and hit F7 key.
  170.  
  171.   NEVER CONNECT TO YOURSELF with BBS enabled !!  I never did this, but
  172. expect to re-boot for this act of insanity.  The program aint that smart
  173. to figure out whether you are typing or the TNC is sending something.
  174.  
  175.   Five WHATS and he is disconnected.  If the BBS doesn't understand a
  176. user's command, it says  *** "R 1"   so the user should read message 1.
  177. He is allowed 5 *** ERRORS and the BBS disconnects.
  178.  
  179.  
  180.    Drop me a note on Amateur radio packet.  N3ET @ N3ET
  181.  
  182.    Randy Lilly  N3ET   (215) 791-3774
  183.    752 S. Carldon St
  184.    Allentown, PA 18103
  185.  
  186.